home *** CD-ROM | disk | FTP | other *** search
/ Technotools / Technotools (Chestnut CD-ROM)(1993).ISO / lantools / actest10 / acctest.doc next >
Text File  |  1990-10-24  |  4KB  |  110 lines
  1.  
  2. acctest is a file ACCess TESTer.  I had Novell networks in mind when I 
  3. wrote this program, though it works without a network, and may work 
  4. with other networks.  acctest is designed to test to see if files are 
  5. available to you (aka-not in use by another user) before you run a 
  6. program depending on these files.  acctest reports its results through 
  7. the DOS errorlevel.
  8.  
  9. acctest was written by Calvin A. Curtindolph on October 24, 1990.
  10.  
  11.  
  12. Command Format:
  13.   acctest [-verbose] [filespec]
  14.  
  15. -verbose
  16. --------
  17. -verbose may be specified as many times as desired on the command 
  18. line.  Each time -verbose is specified, the verbose state is flipped 
  19. (off to on, or on to off).  When acctest is in the verbose state, the 
  20. status of each file tested is announced, with one of the following 
  21. results:
  22.  
  23.   File junk.tst is available
  24.   File junk.tst does not exist
  25.   File junk.tst is not available
  26.  
  27. If the file is not available, that means that the file exists, but 
  28. someone else on the network has use of it.
  29.  
  30. the filespec
  31. ------------
  32. There may be as many file specifications as desired on the command 
  33. line.  Full path specifications and wildcards may be used.  Novell 
  34. volume designators (SYS:, etc) may NOT be used.
  35.  
  36.  
  37. what does acctest return?
  38. -------------------------
  39. If all files named are available, acctest sets the ERRORLEVEL to 0.  
  40. If one or more files are unavailable, the ERRORLEVEL is set to 1.  If 
  41. one or more of the files do not exist, the ERRORLEVEL is set to 2.  
  42. These errorlevels may be tested by a batch file.
  43.  
  44.  
  45. Example of acctest use by itself
  46. --------------------------------
  47. acctest a.b -verbose c.d g:\e.f e:\water\*.g -verbose *.c
  48.  
  49. This line will test for the availability of file a.b, but not display 
  50. results.  The status of files c.d, g:\e.f, and all files matching 
  51. e:\water\*.g will be displayed.  The status of all files matching *.c 
  52. will not be displayed.  The errorlevel will be set as described above.  
  53. Note that if no files match either of the wildcard specifications, 
  54. that specification will be considered a file which cannot be found 
  55. (errorlevel will be set to 2).
  56.  
  57.  
  58. Example of acctest in use in a batch file
  59. -----------------------------------------
  60. @echo off
  61. g:
  62. cd \water
  63. acctest *.fil
  64. if errorlevel 2 goto missing_files
  65. if errorlevel 1 goto in_use
  66. water02
  67. goto end
  68. :in_use
  69. echo  The water system is presently in use.  Please try again later.
  70. goto end
  71. :missing_files
  72. echo  Please tell the System Administrator that necessary data files
  73. echo  are missing.  He will let you know when the system will be ready
  74. echo  for use.
  75. goto end
  76. :end
  77. .
  78. .
  79. .
  80.  
  81. This batch file will run a program called water02 if all files 
  82. matching g:\water\*.fil are available.  If the files are unavailable 
  83. or don't exist, an appropriate message is printed.
  84.  
  85.  
  86. Comments, suggestions, etc
  87. --------------------------
  88. This program (acctest), but not its source code is released into the 
  89. public domain.  If you have comments or suggestions, you may contact 
  90. me via:
  91.  
  92.             Calvin A. Curtindolph
  93.             1434 W. Carmen
  94.             Chicago, IL  60640
  95.  
  96.             Executive Region BBS: 312-267-4749  (IL)
  97.  
  98.             Tool Shop BBS: 602-279-2673  (AZ)
  99.  
  100.             Computer Connections BBS:  202-547-7621  (DC)
  101.  
  102.             Motherboard BBS:  707-778-8841  (CA)
  103.  
  104.             Compu$erve  72060,3717 
  105.             
  106. I log onto CI$ very infrequently; BBS messages will be answered 
  107. faster.  Also, I am not sysop of any of the above mentioned BBSs; they 
  108. are just systems I call fairly often.
  109.  
  110.